<!DOCTYPE html>
<html lang="en">
<head>
	<meta charset="UTF-8">
	<meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
	<title>Geohash 网格聚合 | Elasticsearch: 权威指南 | Elastic</title>
    <!-- Give IE8 a fighting chance -->
    <!--[if lt IE 9]>
    <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
    <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
    <![endif]-->
	<link rel="stylesheet" type="text/css" href="../static/styles.css" />
</head>
<body>
<div class="main-container">
    <section id="content">
        
        <div class="content-wrapper">
            <section id="guide" lang="zh_cn">
                <div class="container">
                    <div class="row">
                        <div class="col-xs-12 col-sm-8 col-md-8 guide-section">
                            <div style="color:gray; word-break: break-all; font-size:12px;">原文地址: <a href="https://www.elastic.co/guide/cn/elasticsearch/guide/current/geohash-grid-agg.html" rel="nofollow">https://www.elastic.co/guide/cn/elasticsearch/guide/current/geohash-grid-agg.html</a>, 版权归 www.elastic.co 所有<br/>
                            英文版地址: <a href="https://www.elastic.co/guide/en/elasticsearch/guide/current/geohash-grid-agg.html" rel="nofollow">https://www.elastic.co/guide/en/elasticsearch/guide/current/geohash-grid-agg.html</a>
                            </div>
                        <!-- start body -->
                  <div class="page_header">
<b>请注意:</b><br>本书基于 Elasticsearch 2.x 版本，有些内容可能已经过时。
</div>
<div id="content">
<div class="breadcrumbs">
<span class="breadcrumb-link"><a href="index.html">Elasticsearch: 权威指南</a></span>
»
<span class="breadcrumb-link"><a href="geoloc.html">地理位置</a></span>
»
<span class="breadcrumb-link"><a href="geo-aggs.html">地理位置聚合</a></span>
»
<span class="breadcrumb-node">Geohash 网格聚合</span>
</div>
<div class="navheader">
<span class="prev">
<a href="geo-distance-agg.html">« 地理距离聚合</a>
</span>
<span class="next">
<a href="geo-bounds-agg.html">地理边界聚合 »</a>
</span>
</div>
<div class="section">
<div class="titlepage"><div><div>
<h2 class="title">
<a id="geohash-grid-agg"></a>Geohash网格聚合 (Geohash Grid Aggregation)<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elasticsearch-cn/elasticsearch-definitive-guide/edit/cn/330_Geo_aggs/64_Geohash_grid_agg.asciidoc">edit</a>
</h2>
</div></div></div>
<p>查询返回的结果可能太多，无法在地图上单独显示每个地理点。 <code class="literal">geohash_grid</code> 按照你定义的精度计算每一个点的 geohash 值，从而将附近的位置聚合在一起 <span style="color:#666;">(译者注: 把坐标点转换成字符串, 位置越是靠近的坐标点, 字符串的前缀的相同值的位数越多)</span>。</p>

<p>结果是一个单元格 - 一个单元格表示一个可以显示在地图上的 geohash 。通过改变 geohash 的精度，你可以按国家或者城市街区来概括全世界。</p>

<p>聚合是<em>稀疏的(sparse)</em> - 它 仅返回那些含有文档的单元。 如果 geohashes 太精确且生成了太多的 buckets，默认情况下，它将返回 10,000 个人口众多的单元格 - 这些单元格包含了人口最多的文档。然而，为了计算哪些是人口最密集的 10,000 个，它还是需要生成 <em>所有</em> 的 buckets 。可以通过以下方式来控制 buckets 产生的数量：
</p>
<div class="olist orderedlist">
<ol class="orderedlist">
<li class="listitem">
使用 <code class="literal">geo_bounding_box</code> 来限制结果。
</li>
<li class="listitem">
为你的边界大小选择一个适当的 精度(<code class="literal">precision</code>)
</li>
</ol>
</div>
<div class="pre_wrapper lang-json">
<pre class="programlisting prettyprint lang-json">GET /attractions/restaurant/_search
{
  "size" : 0,
  "query": {
    "constant_score": {
      "filter": {
        "geo_bounding_box": {
          "location": { <a id="CO240-1"></a><i class="conum" data-value="1"></i>
            "top_left": {
              "lat":  40.8,
              "lon": -74.1
            },
            "bottom_right": {
              "lat":  40.4,
              "lon": -73.7
            }
          }
        }
      }
    }
  },
  "aggs": {
    "new_york": {
      "geohash_grid": { <a id="CO240-2"></a><i class="conum" data-value="2"></i>
        "field":     "location",
        "precision": 5
      }
    }
  }
}</pre>
</div>
<div class="calloutlist">
<table border="0" summary="Callout list">
<tr>
<td align="left" valign="top" width="5%">
<p><a href="#CO240-1"><i class="conum" data-value="1"></i></a></p>
</td>
<td align="left" valign="top">
<p>边界框将搜索限制在大纽约区的范围</p>
</td>
</tr>
<tr>
<td align="left" valign="top" width="5%">
<p><a href="#CO240-2"><i class="conum" data-value="2"></i></a></p>
</td>
<td align="left" valign="top">
<p>Geohashes 的精度 <code class="word">5</code> 大约是 5km x 5km。</p>
</td>
</tr>
</table>
</div>
<p>Geohashes 精度为 <code class="word">5</code> ，每个约25平方公里，所以10000个单元按这个精度将覆盖250000平方公里。我们指定的边界范围，约44km x 33km，或约1452平方公里，所以我们的边界在安全范围内；我们绝对不会在内存中创建了太多的 buckets。</p>
<p>前面的请求的响应数据看起来是这样的：</p>
<div class="pre_wrapper lang-json">
<pre class="programlisting prettyprint lang-json">...
"aggregations": {
  "new_york": {
     "buckets": [ <a id="CO241-1"></a><i class="conum" data-value="1"></i>
        {
           "key": "dr5rs",
           "doc_count": 2
        },
        {
           "key": "dr5re",
           "doc_count": 1
        }
     ]
  }
}
...</pre>
</div>
<div class="calloutlist">
<table border="0" summary="Callout list">
<tr>
<td align="left" valign="top" width="5%">
<p><a href="#CO241-1"><i class="conum" data-value="1"></i></a></p>
</td>
<td align="left" valign="top">
<p>每个 bucket 包含作为 <code class="literal">key</code> 的 geohash 值</p>
</td>
</tr>
</table>
</div>
<p>同样，我们也没有指定任何子聚合，所以我们得到的是文档的数量。如果有需要，我们也可以了解这些 buckets 中受欢迎的餐厅类型、平均价格或其他细节。</p>
<div class="tip admon">
<div class="icon"></div>
<div class="admon_content">
<p>要在地图上绘制这些 buckets，你需要一个将 geohash 转换成同等边界框或中心点的库。JavaScript 和其他语言已有的库会为你执行这个转换，但你也可以使用来自 <a class="xref" href="geo-bounds-agg.html" title="地理边界聚合">geo-bounds-agg</a> 的信息来处理类似的工作。</p>
</div>
</div>
</div>
<div class="navfooter">
<span class="prev">
<a href="geo-distance-agg.html">« 地理距离聚合</a>
</span>
<span class="next">
<a href="geo-bounds-agg.html">地理边界聚合 »</a>
</span>
</div>
</div>

                  <!-- end body -->
                        </div>
                        <div class="col-xs-12 col-sm-4 col-md-4" id="right_col">
                        
                        </div>
                    </div>
                </div>
            </section>
        </div>
    </section>
</div>
<script src="../static/cn.js"></script>
</body>
</html>